home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr36 / tune201.zip / TUNE.DOC < prev    next >
Text File  |  1993-04-04  |  12KB  |  258 lines
  1.  
  2.  
  3.  
  4.                        NAME THAT TUNEDOOR v2.1
  5.                           By Robert Butler
  6.  
  7.  
  8.      Please read the file instr.asc for the rules of the game, they are
  9.      extremely simple!
  10.  
  11.      Name That TuneDoor needs to find one of the folowing files in order
  12.      to run proprely: DORINFO1.DEF, DORINFOx.DEF or DOOR.SYS  The door should
  13.      run with any BBS software that is capable of creating one of these
  14.      files, there are several door conversion utilities available through
  15.      BBS's that will convert drop files to these formats.
  16.      The zip file TUNE21B.ZIP should contain the Following files:
  17.      Note: these files need to be in the directory from which
  18.      you plan to run the game:
  19.  
  20.                          ENVIRONMENTAL VARIABLE:
  21.                          -----------------------
  22.      There is one optional environmental variable that you can add to
  23.        your Autoexec.bat file or the Batch file that runs the door:
  24.                             SET OUTBUFF=OFF
  25.      This turns off output buffering and helps to make hotkeys work
  26.      faster in some instances.  Use this only if you are experiencing
  27.      problems with slow hotkey response.
  28.  
  29.                              INSTALLATION:
  30.                              -------------
  31.      TUNE.EXE      The main program.
  32.      TUNE.DOC      The file you're reading now!
  33.      INSTR.ANS     The game instructions, can be viewed online.
  34.      INSTR.ASC     ASCII version of INSTR.ANS.
  35.      SONGS.DAT     Data file containing songs, clues, etc.
  36.      INSTALL.EXE   Used to create config & batch files for the door.
  37.      HOF.EXE       Creates cumulative top scores lists.
  38.      RESET.EXE     Resets Player's HOF data to zero.
  39.      TUNEDATA.EXE  Songlist Utility program(Registered users Only)
  40.      REGISTER.FRM  Registration form
  41.  
  42.      In addition, Name That Tune Door will create the following files the
  43.      first time it runs:
  44.  
  45.      PLAYER.NTT   holds info. on players.
  46.      SCORES.NTT   Contains the top 30 scores.
  47.  
  48.      and, if running multinode:
  49.      NTTUNE.USE   Passes information between nodes.
  50.  
  51.      The file SONGS.DAT contains a listing of 93 songs, mostly from
  52.      popular music.  Unregistered versions cannot make use of the
  53.      INTERMEDIATE and EXPERT level songs, however, the Registration key
  54.      will unlock all of SONGS.DAT which contains 200+ songs including songs
  55.      at the INTERMEDIATE and EXPERT levels.  The key will also unlock the
  56.      utilitity program TUNEDATA that will enable the Sysop to Add or Delete
  57.      songs from SONGS.DAT, print the songlist or create a new song file!
  58.  
  59.  
  60.                         NAME THAT TUNE DOOR FEATURES:
  61.                         -----------------------------
  62.  
  63.        *  Real-time multinode capability.  Upto 4 nodes can be playing the
  64.           door simutaneously.
  65.  
  66.        *  Hot keys for those who don't want to wait for screens to
  67.           draw themselves before making a menu selection.
  68.  
  69.        *  Install program included to easily create the necessary
  70.           config and batch files to run the game.
  71.  
  72.        *  3 minute inactivity timer will transfer control back to
  73.           the BBS if user "falls asleep".
  74.  
  75.        *  Carrier Detect will transfer control back to the BBS if
  76.           caller drops carrier (hangs up).
  77.  
  78.        *  A full set of Sysop hot-keys, including chat mode.
  79.  
  80.  
  81.        To install Name That TuneDoor:
  82.      1. Create a subdirectory to hold the Door Files.
  83.         Example C:\BBS\TUNE
  84.      2. Copy the files from TUNE21.ZIP to the new subdirectory.
  85.      3. Run the program INSTALL.EXE  it will create the necessary batch
  86.         files and the config file that the door needs to run.
  87.  
  88.                    THE NAME THAT TUNEDOOR CONFIG FILE:
  89.                    -----------------------------------
  90.  
  91.      The Configuration file will be automatically created for you if you use
  92.      the INSTALL program, however, if you would like to create it or edit it
  93.      with a text editor, you can do so.  The configuration filename will be
  94.      "TUNE.CFG" for single nodes.  Multinode systems need a separate config
  95.      file for each node, they must be named TUNE + NODE + .CFG EXAMPLE:
  96.      TUNE1.CFG TUNE2.CFG TUNE3.CFG TUNE4.CFG
  97.      The config files contain 8 lines.  THE FIRST 3 LINES MUST BE ALL CAPS
  98.      OR YOU WILL GET AN ERROR!  Lines 7 & 8 are case sensitive, so be sure to
  99.      enter them exactly or your registration key will not work!
  100.  
  101.  
  102. Line   Statement       Description
  103. -------------------------------------------------
  104.  1   D:\PATH\        *Path to DORINFO1.DEF (& EXITINFO.BBS)
  105.  2   DORINFO1.DEF    *drop file name(DORINFO1.DEF DORINFOx or DOOR.SYS)
  106.  3   N               *used internally DO NO OMIT!
  107.  4   12345678        *Registration key (0 for unregistered)
  108.  5   3               *number of times a person is allowed to play per day.
  109.  6   10              *minutes allowed per play.
  110.  7   Robert Butler   *Sysop Name.
  111.  8   Lockhart BBS    *BBS Name.
  112.  9   C:\BBS\SCORES.ANS *Full path & name of ANSI top Scores file
  113. 10   C:\BBS\SCORES\ASC *Fulle path & name of ASCII top scores file
  114.  
  115. Note: The Line & Description categories above are for explanation only
  116.      and should not be included in the Config file.
  117.      If you are running an unregistered copy, you will not be able to
  118.      change lines 5 & 6 in the config file from the values shown.
  119.  
  120. Note:
  121. Line 2 DORINFOx.DEF can be DORINFO1.DEF to DORINFO4.DEF. if your system
  122. creates DORINFOx.DEF where x is the node number, then line 2 will need
  123. to be different in each nodes config file.  If you use INSTALL.EXE, it is
  124. assumed that DORINFOx.DEF will be in the main BBS directory, and
  125. DORINFO1.DEF OR DOOR.SYS  will be in the separate node directories IF A
  126. MULTINODE SETUP IS SELECTED.  If single node is selected, INSTALL assumes
  127. ALL TYPES OF DROP FILES TO BE IN THE MAIN BBS DIRECTORY.
  128.  
  129.                     THE NAME THAT TUNEDOOR COMMAND LINE:
  130.                     ------------------------------------
  131.  
  132.      To run the program from a DOS command line or from inside a batch file,
  133.      the syntax of the command line is:
  134.  
  135.                      TUNE NODE
  136.      where:
  137.      NODE = The node number of the node you wish to run.  If you are running
  138.      a single node BBS then don't put a node number.  If you are running a
  139.      multi node BBS, You will need a separate batch file for each node.
  140.      Do not use 1-4 if you are running Single node.  Valid Range is 1 to 4.
  141.  
  142.              RUNNING THE DOOR MULTINODE FROM A BATCH FILE:
  143.              ---------------------------------------------
  144.  
  145.      If you wish to run the Door in multinode mode, you could create a
  146.      separate batch file for each node, but a single batch file with IF
  147.      and GOTO statements is more efficient, and this is what Install will
  148.      create.  IF YOU ARE MUTLINODE AND RUN A SINGLE BATCH FILE, YOUR BBS
  149.      SOFTWARE MUST BE ABLE TO PASS THE NODE NUMBER TO THE BATCH FILE FROM
  150.      THE BBS MENU LINE THAT INVOKES THE DOOR!  See the next paragraph for
  151.      an example.
  152.  
  153.                      MENU LINE TO INVOKE THE DOOR:
  154.                      -----------------------------
  155.      Name That TuneDoor requires approx. 200k to run single node and 240k
  156.      to run in multinode.  it should be invoked by means of a menu line that
  157.      shells out to a batch file.  For example, for QuickBBS 2.76 this is a
  158.      menu type 7 and the command line would be *C /C BATFILE.BAT , where
  159.      BATFILE is the name of the batch file that runs the Door.  If multinode,
  160.      and using a single batch file, you must pass the node number to the
  161.      batch file.  With QuickBBS for example, this is done by placing a *N
  162.      after the Batch file Name like this: *C /C BATFILE.BAT *N
  163.      Please consult your BBS documentation for the parameter passing
  164.      method of your individual software.
  165.  
  166.                                SYSOP KEYS
  167.                                ----------
  168.  
  169.      The following keys are available to the sysop at the local console
  170.      while a user is online:
  171.              KEY                FUNCTION
  172.              ---            ----------------
  173.            UP ARROW      INCREASE CALLERS TIME LEFT BY 1 MINUTE
  174.            DN ARROW      DECREASE CALLERS TIME LEFT BY 1 MINUTE
  175.            ALT-C         CHAT WITH USER
  176.            ALT-H         DROP CARRIER (HANG UP)
  177.            F1-F4         CHANGE STATUS BAR
  178.            F10           REMOVE STATUS BAR
  179.            Ctrl-Break    QUIT THE GAME AND RETURN TO BBS
  180.  
  181.  
  182.                          HOF & RESET UTILITIES
  183.                          ---------------------
  184.      This short utility program can be run anytime you want to create or
  185.      update ANSI and ASCII versions of a cumulative scores list.  these
  186.      files will be called HOF.ANS and HOF.ASC and will contain a list of
  187.      all the people currently playing the game, their combined score, and
  188.      the number of times they've played.  Since the scores are combined
  189.      the numbers can easily run into the millions!  You can reset these
  190.      values anytime you want by running the program RESET.EXE  This will
  191.      set all the player's combined scores and times played to zero in the
  192.      PLAYER.DAT file.  CAUTION!! If you are not sure that you want to reset
  193.      the player values to zero, copy the file PLAYER.DAT into another
  194.      directory before running RESET.EXE!
  195.  
  196.                               TUNEDATA.EXE
  197.                               ------------
  198.  
  199.      Registered Users will be able to use the utility program TUNEDATA.
  200.      This utility will allow you to access the SONGS.DAT file and perform
  201.      the following functions:
  202.      1. Add Songs to SONGS.DAT
  203.      2. Delete songs from SONGS.DAT
  204.      3. Print a songlist and report of the SONGS.DAT file.
  205.      4. Create your own completely new SONGS.DAT file.
  206.  
  207.      TUNEDATA is run from the command line or batch file in the following
  208.      manner:   TUNEDATA CONFIG   where:
  209.      CONFIG is the name of the Name That Tune Door Config file.
  210.  
  211.                               COPYRIGHT NOTICE
  212.                               ----------------
  213.  
  214.      Name that Tune Door  is  a  copyrighted program  being  distributed
  215.      under the shareware concept.  As such you may use Name That Tune Door
  216.      for a period of 30 days  without  registering  the  software.
  217.      After  the  30  day evaluation period, you  must register your copy of
  218.      Name That Tune Door or you will be in violation of United States and
  219.      International copyright laws.
  220.  
  221.      As a shareware program, Name That Tune Door may be freely distributed
  222.      through a BBS.  Shareware distributors may distribute copies of Name
  223.      That Tune Door on disk  for a modest disk duplication charge not to
  224.      exceed $6 per disk.
  225.                                   WARRANTY
  226.                                   --------
  227.  
  228.      Name That Tune Door is  distributed without warranty.   In no event
  229.      will Robert Butler be liable to you for damages, including any loss
  230.      of profits, lost savings, or other incidental or consequential damages
  231.      arising out of your use of or inability to use the program, even if
  232.      Robert Butler or an authorized representative has been advised of the
  233.      possibility of such damages.  Robert Butler will not be liable for any
  234.      such claim by any other party.
  235.  
  236.                                  REGISTRATION
  237.                                  ------------
  238.  
  239.      Please use United States Currency ONLY!  Simply print the file
  240.      REGISTER.FRM and follow the instructions included in it.
  241.  
  242.      There are 3 different registration fee types for Name That TuneDoor:
  243.      1. Single Version Registration key is $15.00 U.S. This will work on the
  244.         current version of the Door only.
  245.      2. Unlimited Upgrade Key is $30.00 U.S.  This key will work on this and
  246.         all future versions of Name That TuneDoor.
  247.      3. Upgrade Key is $5.00 U.S. and is available to people who previously
  248.         Registered with a Single Version Key.
  249.  
  250.      The shareware copy you have contains all the necessary files, there
  251.      is nothing left out.
  252.      Registered owners will recieve a registration key via BBS or Fidonet
  253.      NetMail Msg.   The registration key will unlock:
  254.      1. The # of Plays per Day config statement.
  255.      2. The # of Minutes per Play config statement.
  256.      3. Turn off Beep at beginning and end of each game.
  257.  
  258.